home *** CD-ROM | disk | FTP | other *** search
/ PC User 2003 December / Australian PC User - December 2003 (CD2).iso / magstuff / linux / files / README.txt < prev   
Encoding:
Text File  |  2003-10-16  |  4.0 KB  |  105 lines

  1. NetHack 3.4.2 Linux Elf
  2.  
  3. This README provides the instructions for using the official Linux binary,
  4. system platform requirements, as well as steps used to create that binary.
  5. The same steps can be used from the source distribution to create a similar
  6. binary.
  7.  
  8. The official Linux binary has support for tty and X11 windowing systems, but
  9. not Qt.  This means you will need to have X11 libraries installed on your
  10. system to run this binary, even in its tty flavor.
  11.  
  12.  
  13. The Linux binary package assumes that you have a user and a group named
  14. "games" on your system.  If you do not, you can simplify installation by
  15. creating them first.
  16.  
  17. Log in as or su to "root".  Then, cd /, gunzip and untar the package,
  18. preserving permissions to put the NetHack files in /usr/games/nethack and
  19. /usr/games/lib/nethackdir.   For example, if the package in in your
  20. home directory you might perform these steps.
  21.     % su
  22.     # cd /
  23.     # gunzip -c ~yourlogin/nh342lin.tgz | tar xpvf -
  24.  
  25. (If you have old record and logfile entries from a previous NetHack version,
  26. you might want to save copies before they get overwritten by the new empty
  27. files; old saved games and bones files from 3.4.x will work with 3.4.2).
  28.  
  29. In addition to data files for running the game, you will find other useful
  30. things in /usr/games/lib/nethackdir (such as a copy of this README :-).
  31.  
  32. The general documentation Guidebook.txt and the processed man pages
  33. nethack.txt and recover.txt should provide an introduction to the game.
  34.  
  35. The sample config file called dot.nethackrc can be used by copying
  36. it to your home directory as .nethackrc and modifying it to your liking.
  37.  
  38. If you are running X11 copy the nh10.pcf and ibm.pcf font files from
  39. /usr/games/lib/nethackdir to a X11 fonts directory (such as
  40. /usr/X11/lib/X11/fonts/misc) and run "mkfontdir", then restart X
  41. windows to load them.  If you prefer to use the graphical tiles,
  42. add the following to your .Xdefaults or .Xresources file:
  43.     NetHack.tile_file: x11tiles
  44. You may need to run "xrdb -merge $HOME/.Xdefaults" (or .Xresources) after
  45. doing this.
  46.  
  47. The official Linux binary is set up to run setgid games, which allows
  48. multiple users on your system to play the game and prevents cheating by
  49. unprivileged users.  The usual default for NetHack is setuid games, but
  50. this causes problems with accessing .nethackrc on distributions with
  51. restrictive default security on home directories and users who don't know
  52. the tradeoffs of various permission settings.
  53.  
  54.  
  55. If you have problems, send us some email.
  56.  
  57. nethack-bugs@nethack.org
  58.  
  59.  
  60.  
  61. Steps used to build this binary release, in addition to the basic
  62. instructions found in sys/unix/Install.unx.  The step numbers below
  63. correspond to the step numbers in sys/unix/Install.unx.
  64.  
  65. System:  gcc-3.2, XFree86-libs-4.2.1, ncurses-5.2, glibc-2.3.2 (GLIBC_2.3)
  66.  
  67. 3.  Edit include/config.h and include/unixconf.h
  68.     config.h: define X11_GRAPHICS window support.
  69.               define USE_XPM support.
  70.               define COMPRESS as /bin/gzip as that is where it
  71.               seems to reside on newer Linux's.
  72.               define COMPRESS_EXTENSION as ".gz"
  73.               define DLB
  74.  
  75.     unixconf.h: define LINUX
  76.                 define TIMED_DELAY
  77.  
  78. 6.  Makefile.src: define modern, non-BSD Linux and linux options throughout
  79.           CC = gcc
  80.           LFLAGS = -L/usr/X11R6/lib
  81.           WINSRC = $(WINTTYSRC) $(WINX11SRC)
  82.           WINOBJ = $(WINTTYOBJ) $(WINX11OBJ)
  83.           WINTTYLIB = /usr/lib/libncurses.a
  84.           WINX11LIB = -lXaw -lXmu -lXext -lXt -lXpm -lX11
  85.           WINLIB = $(WINTTYLIB) $(WINX11LIB)
  86.  
  87.     Makefile.utl: define modern, non-BSD Linux and linux options throughout
  88.                   Use bison/flex instead of yacc/lex
  89.           CC = gcc
  90.           LFLAGS = -L/usr/X11R6/lib
  91.           YACC = bison -y
  92.           LEX = flex
  93.  
  94. 7.  Makefile.top: GAMEGRP = games
  95.           GAMEPERM = 02755
  96.           FILEPERM = 0664
  97.           EXEPERM = 0755
  98.           DIRPERM = 0775
  99.           VARDATND = x11tiles NetHack.ad pet_mark.xbm rip.xpm
  100.  
  101.     make all; su; make install
  102.  
  103. 9.  Additional step: As discussed in win/X11/Install.X11, convert nh10.bdf
  104.     and ibm.bdf to proper font files and place in font path.
  105.